home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbs_soft / sfhdr214.zip / SFHEADER.DOC < prev    next >
Text File  |  1993-04-06  |  9KB  |  199 lines
  1.                          ****  SF-HEADER  ****
  2.                              Version 2.14
  3.                           Copyright (C) 1991-1993
  4.                      By Russell Mikami & Dick Sanders
  5.                           Hawke Software Systems
  6.  
  7.  
  8.    Distribution:
  9.    ------------
  10.    
  11.    SFHEADER is being distributed through the shareware concept.  You 
  12.    may use SFHEADER for an Evaluation period of 30 days.  If at that 
  13.    time you decide you want it, please take the time to register it.
  14.    You may distribute as many copies of SFHEADER as you wish, as long
  15.    as the programs within the archive are not modified in any way.
  16.    The latest version of SFHEADER as well as SPITFIRE and other
  17.    SPITFIRE Utilities can always be downloaded from :
  18.  
  19.                       The Hawaiian Hawke BBS Node 1
  20.                               (602)272-4887
  21.                              1200-19200 Baud
  22.                           USR HST Courier 14400
  23.  
  24.    Once your registration for SFHEADER is recieved, you will also be
  25.    given access to Node 2, which is running a Practical Peripherals
  26.    14400 FXSA v32bis modem.
  27.  
  28.    Disclaimer:
  29.    ----------
  30.  
  31.    The Authors of this program, and/or Hawke Software Systems shall
  32.    in no way be held responsible for any damage incurred while operating
  33.    SFHEADER.  All responsibility lies with the user of the software.
  34.  
  35.  
  36.    Purpose:
  37.    -------
  38.  
  39.    This program was created  for the purpose of making File 
  40.    area headers which includes the information of how many files
  41.    are contained within a particular directory, along with a byte count,
  42.    and Date the listing was last updated by the sysop.  Sfheader now
  43.    offers the capability to Generate FILST<xxx>.BBS/.CLR screens in the
  44.    Unregistered Version.  This software has been designed to work with
  45.    The SPITFIRE Bulletin Board System.
  46.  
  47.    Spitfire is written by Mike Woltz, Buffalo Creek Software.  
  48.    It is an Excellent BBS package that I would recommend to 
  49.    anyone.    
  50.  
  51.  
  52.    Usage:
  53.    -----
  54.  
  55.    This program can be run from your any directory which is in your path, 
  56.    assuming that your SFPATH environment is set.  If you do not have this
  57.    environment set, all you need to do is add the following command line
  58.    to your autoexec.bat file:
  59.  
  60.                          SET SFPATH=C:\SF
  61.  
  62.    I used c:\sf for the directory in the example, but obviously, it should
  63.    be set for your particular system's configuration.  If you do not wish to
  64.    add this statement to your autoexec.bat file,  then the program WILL have
  65.    to be run from the Spitfire system directory.  The 10, 20, and 999 after the
  66.    word SFHEADER below signifies the Different Security Levels that can be
  67.    used on the command line to generate the FILST<xxx>.BBS/CLR Screens.  For
  68.    Example SFHEADER 10 20 999  would generate FILST screens for Level 10, 20,
  69.    and 999.  If you do not want these screens to be generated, simply leave 
  70.    these Parameters out.
  71.  
  72.    To test run SFHEADER, assuming the environment is NOT set, place SFHEADER
  73.    in your SF system directory.  Then simply type
  74.  
  75.                     SFHEADER.exe 10 20 999
  76.     
  77.    If the SFPATH has been set in your autoexec.bat file, then just copy
  78.    SFHEADER to any directory that is in your path, and then type SFHEADER,
  79.    and after seeing a brief opening screen, all of your SPITFIRE Area
  80.    Directory files (SFFiles.BBS) will be read, and a new header will
  81.    preface each such file listing with the following information:
  82.  
  83. ╒═════════════════════════════════════════════════════════════════════════════╕
  84. │                   Area 9 ─ Spitfire BBS & Utilities                         │
  85. │  Total Files: 539                                   Total Bytes: 9,880,721  │
  86. │                                                                             │3
  87. │                The Hawaiian Hawke BBS - Home of SF-Header !!                │4
  88. │                                                                             │5
  89. │  *** SF-Header v.2.14 ***                    Registered to: Russell Mikami  │
  90. ╞═════════════════════════════════════════════════════════════════════════════╡
  91. │  Filename     Size      Date    Description        Last Updated: 2/23/1993  │
  92. ╘═════════════════════════════════════════════════════════════════════════════╛
  93.  
  94.   SF-HEADER now will support up to 2000 files per area (Pertains to Both
  95.   registered, and unregistered versions), will also NOT make backups 
  96.   of your sffiles.bbs if this is what you wish, and the REGISTERED Version
  97.   now gives the Sysop 3 lines to configure as they wish.   The 3 lines that
  98.   are configurable are marked as 3,4,5 above to the right of the box.
  99.  
  100. **** NOTE ****
  101.  
  102.   You MUST run SFHDRCFG.exe  to create your "Customized" header config file.
  103.   The Unregistered Version will not allow the configurability that the 
  104.   registered version has.  Also, The SFHEADER program can be run from ANY 
  105.   AREA in your path, as long as the SFPATH variable is set.   Also, be sure
  106.   that your newly created SFHEADER.CFG file is in the same dir as your
  107.   sfheader.exe program, or the directory where you are running it from,
  108.   or it will not work properly.
  109.  
  110.   For example, I have my sfheader.exe program in a directory that is in my
  111.   path, and I run my sfheader from my ram drive to speed things up,so I 
  112.   always have a copy of my sfheader.cfg file in my ram drive.
  113.  
  114.  
  115. ****  The above paragraph pertains to registered versions only. ****
  116.  
  117.  
  118.  
  119.    That's all there is to it.  The program will not process any 
  120.    file areas that do not contain an sffiles.bbs file listing.  
  121.    The original sffiles.bbs listing will be renamed to 
  122.    sffiles.bak, and the newly created sffiles.bbs created by 
  123.    SFHEADER will be your new listing.  When totaling files in the 
  124.    directory, this program WILL NOT count the sffiles.bbs & .bak 
  125.    in its total, nor will it count its byte size.
  126.  
  127.    This program can best be utilized by running it from a batch file,
  128.    which might look something like this:
  129.  
  130.                     c:
  131.                     cd\sf
  132.                     sfheader.exe  10 20 50 999
  133.                     goto loop
  134.   
  135. ** NOTE **
  136.  
  137.    This example is assuming that the program is registered, and
  138.    running as an event.  With the UNREGISTERED version, there is a short
  139.    delay, requiring the input of a carriage return to initiate
  140.    operation.
  141.  
  142. ** END OF NOTE **
  143.  
  144.    The Filst<xxx>.bbs screens are Generated by adding the security Levels
  145.    to the command line.  This feature is fully operational in  the 
  146.    Unregistered version.  Sfheader will put the  FILST<xxx> screens in 
  147.    your display directory that you have configured in Spitfire.  Also, if
  148.    an area is set for YES to Preview, then sfheader will include that area
  149.    in the necessary FILST screens.
  150.  
  151. ********   REMEMBER   ********
  152.  
  153.     There must be an existing sffiles.bbs in the directory being 
  154.     processed or the area will not be affected by SFHEADER.    
  155.    
  156.     If you have any comments, problems, or questions about this 
  157.     program, I can be reached by Crash Mail, through the Third
  158.     party Authors/Doors Conference in Circuit-Net, or of course
  159.     you can call The Hawaiian Hawke BBS for Support.
  160.  
  161.  
  162.     REGISTRATION INFORMATION:
  163.  
  164.     A $10 registration fee includes:
  165.  
  166.     A specially compiled copy for you of SFHEADER which may either be:
  167.  
  168.      1)  Downloaded directly from the Hawaiian Hawke BBS, or
  169.  
  170.  ==> 2)  For a small fee, we will upload a registered copy to your BBS,
  171.          or mail it to you.  Please read register.doc for options.
  172.  
  173.      3)  Voice Support also, if needed for Registered Users of SFHEADER.
  174.  
  175.     All future upgrades can be downloaded from The Support Board, The
  176.     Hawaiian Hawke BBS at (602) 272-4887.  At this time, I see no need 
  177.     to charge for upgrades, so therefore, they are free, except for the
  178.     time you will take to download it.
  179.  
  180.     For any special situations not covered here, I suggest trying to
  181.     reach me thru one of the following Net addresses.
  182.  
  183.     FIDO Netmail Address  -  1:114/67     
  184.     ICN  Netmail Address  -  91:602/18
  185.  
  186.     I can also be routed a message at Node # 602003 Via Any Sysop 
  187.     Level Circuit-Net Conference, to include the Third party 
  188.     Author's conference. Inquiries via Postal Service mail will
  189.     also be accepted.
  190.  
  191.     If you like this program and would like to register it, Please send
  192.     Check or Money Order with a filled out copy of register.doc 
  193.     to:
  194.  
  195.            Russell Mikami
  196.            The Hawaiian Hawke BBS
  197.            P.O. Box 2506
  198.            Phoenix, Az 85002-2506
  199.